home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 #1 / Ham Radio 2000.iso / ham2000 / rigctrl / catcntrl / readme < prev    next >
Encoding:
Text File  |  1996-04-01  |  9.0 KB  |  164 lines

  1.               March 31, 1996
  2.  
  3.                A Computer Aided Tuning program for the Yaesu FT-767GX
  4.                               Eugene L. Langberg WA3AKK
  5.                                     P. O. Box 176
  6.                                Gwynedd Valley, PA 19437
  7.  
  8.               This disk has the following programs on it:
  9.  
  10.                    CATCOM1.C          Source and Binary files for
  11.                    CATCOM1.EXE        use through PC serial port COM1
  12.  
  13.                    CATCOM2.c          Source and Binary files for
  14.                    CATCOM2.EXE        use through PC serial port COM2
  15.  
  16.                    LISTING.TXT        A listing of CATCOM2.C with line
  17.                                       numbers    and   an   index   to 
  18.                                       functions to facilitate finding
  19.                                       one's way through the code.
  20.                    
  21.                    GENERAL.DAT        A sample list of stored General
  22.                                       stations.
  23.                    REPEATER.DAT       The same for repeaters.
  24.  
  25.                    README             This file.                      
  26.  
  27.               The Hardware Setup
  28.  
  29.               The  Yaesu  FT-767GX  is connected to a  Yaesu  FIF-232C 
  30.               through the transceiver's 6 pin Din Cat Jack on the rear 
  31.               panel.   The FIF-232C converts the receiver's TTL levels 
  32.               to  RS-232C  levels.  An  AT type PC's  serial  port  is 
  33.               connected to  the FIF-232C's 25 pin connector which only 
  34.               uses 5 lines.  The FIF-232C uses pin 2 as TXD,  pin 3 as 
  35.               RXD, pin 5 as CTS, pin 6 as DSR and pin 7 as common. 
  36.  
  37.               In  my  setup,  the computer was about 75 feet from  the 
  38.               FIF-232C   but  still  worked  well.    During   program 
  39.               development  I  used a 486 AT machine because I  used  a 
  40.               Microsoft  C/C++  Version  7 compiler which requires  at 
  41.               least a 386.   I also went into the computer through its 
  42.               COM2  port.  (There  is  a mouse connected to  its  COM1 
  43.               port.)
  44.  
  45.               Since  the program was developed I use  an AT 286 Compaq 
  46.               portable through its COM1 port. It too works well.
  47.  
  48.               The nature of the Software
  49.  
  50.               The  program was first developed in 1990 to operate on a 
  51.               PDP-11/23.   It  was  developed  using the old  DECUS  C 
  52.               compiler whose last release,  that I am aware of, was in 
  53.               1981.   It  was  a  K&R  compiler with  a  very  limited 
  54.               library.   The  program  was limited to  tuning the  FT-
  55.               767GX  using all of the commands made available by Yaesu 
  56.               in the set's protocol.  The program worked very well and 
  57.               never ceased to amaze me in the speed with which the set 
  58.               responded to my commands.
  59.  
  60.               In  1994 I decided to port many programs from the PDP-11 
  61.               to  the PC.  (The PDP-11/23 is getting to be a very  old 
  62.               machine.)  Among them this program,  which was ported in 
  63.               1995.  The first roughly 1200 lines of code are from the 
  64.               original program with many changes required to get it to 
  65.               compile under the ANSI C/C++  compiler.  The rest of the 
  66.               code  was added to increase the memory for stations from 
  67.               10 in the FT-767GX almost as many as you want.   At this 
  68.               point  the  program  is  set  to  remember  100  general 
  69.               receiver   stations  in  the  GENERAL.DAT  file  and  25 
  70.               repeater  pairs  in  the  REPEATER.DAT  file.    Without 
  71.               changing  the  memory model under which the  program  is 
  72.               compiled, (the default model) the GENERAL.DAT memory can 
  73.               be  extended to about 450 stations and the  REPEATER.DAT 
  74.               memory  can be extended to about 250.  I selected 100 in 
  75.               one  and  25  in the other because these  seemed  to  be 
  76.               enough for my area and the way I operate.
  77.  
  78.               The program's operation in general
  79.  
  80.               On  startup the program does some checking.  The program 
  81.               requires  ANSI.SYS for correct displays.  Therefor,  its 
  82.               first  action is to check to see if ANSI.SYS was  loaded 
  83.               when the machine was booted.  If it was not you are told 
  84.               to  add it to your config.sys file and reboot,  and  the 
  85.               program exits to DOS.      
  86.  
  87.               If  ANSI.SYS is present a help screen appears.  The help 
  88.               screen  lists 19 commands and their modifiers of the  20 
  89.               given in Yaesu's protocol.   The program assumes that if 
  90.               you are running the program you will want to turn CAT ON 
  91.               when  you start and OFF when you quit,  and so does this 
  92.               for you and hides the CAT command from you.
  93.  
  94.               Three additional commands have been added.  The first is 
  95.               help.  Entering  help  at the prompt brings up the  help 
  96.               screen  to assist you in recalling the commands and what 
  97.               they do.
  98.  
  99.               The  second is diskmem.   Entering diskmem at the prompt 
  100.               takes  you into the part of the program that allows  the 
  101.               manipulation  of the GENERAL.DAT and REPEATER.DAT files. 
  102.               This  allows  you  to create the files,  add  or  remove 
  103.               stations  from  them  by hand, add the station  you  are 
  104.               tuned  to automatically or read through the files to see 
  105.               what  is  there.  You  also have the  option  to  recall 
  106.               stations   listed   in  the  DAT  files  and  doing   so 
  107.               automatically tunes the set to the selected station.  
  108.  
  109.               The third is edit.  When you save or store a station you 
  110.               are  tuned  to  the program  automatically  records  the 
  111.               information  in the VFOs,  frequency,  mode etc.  but it 
  112.               asks  you  for the station's call letters and  location. 
  113.               Often  I do not know these,  therefor I will enter  some 
  114.               question  marks.  Edit is available only when you  first 
  115.               bring  the program up and it allows you to edit the call 
  116.               letters  and location fields to correct them or add them 
  117.               when  you  learn what they are.  You are allowed to  use 
  118.               edit even if the radio is not turned on.  
  119.  
  120.               If  you  do not enter edit but press return the  program 
  121.               proceeds to initialize the port to meet the requirements 
  122.               of  the FT-767GX.   It then checks the port to see if it 
  123.               is live.   If it is not,  a message is displayed telling 
  124.               you  to  check  the cable connections and  turn  on  the 
  125.               interface device, and then exits to dos.  If the port is 
  126.               live, (CTS & DSR are asserted) the program sends a check 
  127.               command  to  the FT-767GX and displays  the  information 
  128.               returned  by  the radio.   You are up and  running,  the 
  129.               cursor  moves  to a corner bracket prompt symbol in  the 
  130.               lower  left  corner of the screen and all is  ready  for 
  131.               your commands.
  132.  
  133.               Some general remarks
  134.  
  135.               The  program  code  is not greatly  commented.   I  hate 
  136.               obfuscated  code  in any language and therefor  tend  to 
  137.               write code in simple form.  I find that I can go back to 
  138.               the code after some time and still understand it.   This 
  139.               code  is not difficult to follow.   However,  some of it 
  140.               may  appear  to be meaningless without reference to  the 
  141.               protocol  listed  in  the last three  pages  of  Yaesu's 
  142.               operating  manual  for the FT-767GX.   I  have  included 
  143.               copies with the disk.
  144.  
  145.               For  ease  in  finding  ones way around in  the  code  I 
  146.               suggest  that one read the file LISTING.TXT rather  than 
  147.               one  of the *.C files.   The code in both CATCOM2.C  and 
  148.               LISTING.TXT  is  the  same.  The difference is  that  in 
  149.               LISTING.TXT there are line numbers in front of each line 
  150.               of code and an index list at the start.   If you want to 
  151.               find main for example,  look in the index list for main. 
  152.               Note  the  number in front of main.  Then look for  that 
  153.               line in the code by number and it will be main.
  154.  
  155.               Have fun.
  156.  
  157.               DISCLAIMER
  158.  
  159.               I release this software to the public domain for use by 
  160.               anyone who wants it. It's not copyrighted, comes with no 
  161.               support and I disclaim any responsibility for any 
  162.               consequential damages resulting from its use, correct or
  163.               otherwise.
  164.